home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / quartz / q0867.dms / q0867.adf / TRAPDOOR.LZH / Docs / TrapList.Man < prev    next >
Text File  |  1992-11-07  |  50KB  |  1,490 lines
  1.  
  2.  
  3.      Page 1        TrapDoor's Faaaast NodeList Processor        Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                  TrapList
  22.                    TrapDoor's Faaaast NodeList Processor
  23.                                Version 1.45
  24.                           Copyright (c) 1990-1992
  25.                    Martin Laubach and Maximilian Hantsch
  26.                             All rights reserved
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                          TrapList's Faaaast Manual
  34.                         Thursday 05-Nov-92 10:23:58
  35.                           Copyright (c) 1990-1992
  36.                    Martin Laubach and Maximilian Hantsch
  37.                             All rights reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                   This manual is intended to be read from
  48.                     front to back for more convenience.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.      Page 2        TrapDoor's Faaaast NodeList Processor        Page 2
  66.  
  67.  
  68.   1. Introduction     
  69.  
  70.        This document is a brief description of TrapList, TrapDoor's
  71.      fast Nodelist Processor, explaining how to set up the software
  72.      in order to compile FidoNet compatible Nodelists and apply
  73.      Nodediffs to them.  
  74.  
  75.        Please read the entire manual before using TrapList.  
  76.  
  77.        TrapList reads FidoNet compatible Nodelist and Nodediff files
  78.      and produces an index and an extra file as outputs. These files
  79.      are later used by TrapDoor to access the actual Nodelist in a
  80.      fast way and to obtain important data from there, such as
  81.      telephone numbers and session passwords.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.   2. Basics     
  92.  
  93.        TrapList is a CLI based application, it can't be run from
  94.      WorkBench. It accepts a wide range of configuration statements
  95.      that allow an easy and accurate configuration.  
  96.  
  97.        On invocation through a standard commandline interface or
  98.      shell, TrapList will parse its configuration file, look for
  99.      nodelist and nodediff files, apply matching nodediffs, parse the
  100.      final nodelists, sort the nodes, delete duplicate entries and
  101.      finally, write out an index as well as an extra file, both of
  102.      them to the directory specified in the NODELISTPATH
  103.      configuration statement.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.      Basics
  125.  
  126.  
  127.      Page 3        TrapDoor's Faaaast NodeList Processor        Page 3
  128.  
  129.  
  130.   3. The Nodelist    
  131.  
  132.   3.1. General Information    
  133.  
  134.        The Nodelist is a file that contains important data about all
  135.      the nodes in FidoNet. It is often called "the glue which holds
  136.      the network together". It is FidoNet's "phone book" and it
  137.      defines the top-level network structure.  
  138.  
  139.        The Nodelist is published each Friday as an ASCII text file
  140.      named NODELIST.nnn, where nnn is the day-of-year of the Friday
  141.      publication date. This file is packed into an standard archive
  142.      file (using System Enhancement Associates' ARC file format)
  143.      named NODELIST.Ann, where nn are the last two digits of
  144.      day-of-year.  
  145.  
  146.        You can skip the next chapter if you want. It is just here to
  147.      supply you with additional background information about the
  148.      format of the nodelist.  You may want to come back to it when
  149.      you need to build your own private nodelists, such as for a
  150.      private point network.  
  151.  
  152.   3.2. Details     
  153.  
  154.        The Nodelist contains two kinds of lines, comment lines and
  155.      data lines.  Each line is terminated with an ASCII carriage
  156.      return and line feed character sequence, and contains no
  157.      trailing white-space (spaces, tabs, etc.). The file is
  158.      terminated with an end-of-file character (EOF = decimal
  159.      character value 26).  
  160.  
  161.        Comments lines contain a semicolon (;) in the first character
  162.      position followed by zero or more alphabetic characters called
  163.      "interest flags".  The remainder of a comment line (with one
  164.      exception, treated below) is free-form ASCII text. There are
  165.      five interest flags defined as follows: 
  166.  
  167.           ;S This comment is of particular interest to Sysops.
  168.           ;U This comment is of particular interest to BBS users.
  169.           ;F This comment should appear in any formatted "Fido List".
  170.           ;A This comment is of general interest (shorthand for ;SUF).
  171.           ;E This comment is an error message inserted by the nodelist
  172.                generating program MakeNL.
  173.           ; This comment may be ignored by a nodelist processor.
  174.  
  175.        The first line of a nodelist is a special comment line
  176.      containing identification data for the particular edition of the
  177.      nodelist. The following is an example of the first line of a
  178.      nodelist: 
  179.  
  180.           ;A FidoNet Nodelist for Friday, July 3, 1987 --
  181.                Day number 184 : 15943
  182.  
  183.        This line contains the general interest flag, the day, date,
  184.  
  185.  
  186.      The Nodelist                                          Details
  187.  
  188.  
  189.      Page 4        TrapDoor's Faaaast NodeList Processor        Page 4
  190.  
  191.  
  192.      and day-of-year number of publication, and ends with a 5-digit
  193.      decimal number with leading zeros, if necessary. This number is
  194.      a 16-bit cyclic redundancy check (CRC) for the entire Nodelist
  195.      file to ensure its integrity. The CRC may be used to verify that
  196.      the file has not been edited. The importance of this will become
  197.      evident in the discussion of NODEDIFF, below.  
  198.  
  199.        The content of the remaining comments in the nodelist are
  200.      intended to be informative. TrapList does not have any interest
  201.      in them at all.  
  202.  
  203.        A nodelist data line contains eight variable length "fields"
  204.      separated by commas (,). No space characters are allowed in a
  205.      data line, and underscore characters are used in lieu of spaces.
  206.      The term "alphanumeric character" is defined as the portion of
  207.      the ASCII character set from 20 hex through 7E hex, inclusive.
  208.      The following discussion defines the contents of each field in a
  209.      data line.  
  210.  
  211.      Field 1: Keyword   
  212.  
  213.        The keyword field may be empty, or may contain one of the
  214.      following: 
  215.  
  216.        Zone -- Begins the definition of a geographic zone and defines
  217.             its coordinator (Zone:0/0.0). All the data lines
  218.             following a line with the "Zone" keyword down to, but not
  219.             including, the next occurrence of a "Zone" keyword, are
  220.             regions, networks, and nodes within the defined zone.  
  221.  
  222.        Region -- Begins the definition of a geographic region and
  223.             defines its coordinator (Zone:Region/0.0). All the data
  224.             lines following a line with the "Region" keyword down to,
  225.             but not including, the next occurrence of a "Zone",
  226.             "Region", or "Host" keyword, are independent nodes within
  227.             the defined region.  
  228.  
  229.        Host -- Begins the definition of a local network and defines
  230.             its host (Zone:Host/0.0).  All the data lines following a
  231.             line with the Host keyword down to, but not including,
  232.             the next occurrence of a "Zone", "Region", or "Host"
  233.             keyword, are local nodes, members of the defined local
  234.             network.  
  235.  
  236.        Hub -- Begins the definition of a routing subunit within a
  237.             multilevel local network and defines its hub system
  238.             (Zone:Host/Hub.0). The hub is the routing focal point for
  239.             nodes listed below it until the next occurrence of a
  240.             "Zone", "Region", "Host", or "Hub" keyword. The hub entry
  241.             MUST be a redundant entry, with a unique number, for one
  242.             of the nodes listed below it. This is necessary because
  243.             some nodelist processors eliminate these entries in all
  244.             but the local network.  
  245.  
  246.  
  247.  
  248.      The Nodelist                                   Field 1: Keyword
  249.  
  250.  
  251.      Page 5        TrapDoor's Faaaast NodeList Processor        Page 5
  252.  
  253.  
  254.        Pvt -- Defines a private node with an unlisted telephone
  255.             number. Private nodes are only allowed as members of
  256.             local networks.  
  257.  
  258.        Hold -- Defines a node which is temporarily down. Mail may be
  259.             sent to it and is held by its host or coordinator.  
  260.  
  261.        Down -- Defines a node which is not operational. Mail may NOT
  262.             be sent to it. This keyword may not be used for longer
  263.             than two weeks on any single node, at which point the
  264.             "down" node is to be removed from the nodelist.  
  265.  
  266.        <empty> -- Defines a normal node entry (Zone:Host/Node.0 or
  267.             Zone:Region/Node.0).  
  268.  
  269.        Point -- Defines a point entry in a private pointnet
  270.             (Zone:Region/Node.Point). This keyword is never used in
  271.             the FidoNet distribution nodelist, but it is a TrapList
  272.             extension to allow easy setup of private pointnets.
  273.             Points defined with this keyword belong the the
  274.             previously listed node and end at the next Zone, Region,
  275.             Host, Hub, or normal node entry.  
  276.  
  277.      Field 2: Zone/Region/Net/Node number  
  278.  
  279.        This field contains only numeric digits and is a number in the
  280.      range of 0 to 32767. If the line had the "Zone", "Region", or
  281.      "Host" keyword, the number is the zone, net, or region number,
  282.      and the node has an implied node number of 0. Otherwise, the
  283.      number is the node number. The zone number, region or net
  284.      number, and the node number, taken together, constitute a node's
  285.      FidoNet address.  
  286.  
  287.        Zone numbers must be unique. Region or net numbers must be
  288.      unique within their zone. Hub numbers must be within their net.
  289.      Node numbers must be unique within their region (for regional
  290.      independents) or net (for members of a local network). Duplicate
  291.      node numbers under different hubs within the same net are not
  292.      allowed.  
  293.  
  294.      Field 3: Node name  
  295.  
  296.        This field may contain any alphanumeric characters other than
  297.      commas and spaces. Underscores are used to represent spaces.
  298.      This is the name by which the node is known.  
  299.  
  300.        If this field contains the characters "->", the rest of the
  301.      line will not be parsed (and should be omited). This is never
  302.      used in the FidoNet distribution nodelist, but it is a TrapList
  303.      extension.  It means that internal variables will be set to the
  304.      number provided in field 2, but the node will not be entered
  305.      into the index file.  (There is not even data that could be
  306.      entered.) The "->" extension allows easy setup of private
  307.      pointnets. See the chapter about fake pointnets.  
  308.  
  309.  
  310.      The Nodelist                                  Field 3: Node name
  311.  
  312.  
  313.      Page 6        TrapDoor's Faaaast NodeList Processor        Page 6
  314.  
  315.  
  316.      Field 4: Location   
  317.  
  318.        This field may contain any alphanumeric characters other than
  319.      commas and spaces. Underscores are used to represent spaces.
  320.      This field contains the location of the node. It is usually
  321.      expressed as the primary local location (town, suburb, city,
  322.      etc.) plus the identifier of the regional geopolitical
  323.      administrative district (state, province, department, county,
  324.      etc.). Wherever possible, standard postal abbreviations for the
  325.      major regional district should be used (IL, BC, NSW, etc.).  
  326.  
  327.      Field 5: Sysop name  
  328.  
  329.        This field may contain any alphanumeric characters other than
  330.      commas and spaces. Underscores are used to represent spaces.
  331.      This is the name of the system operator.  
  332.  
  333.      Field 6: Phone number  
  334.  
  335.        This field contains at least three and usually four numeric
  336.      subfields separated by dashes (-). The fields are country code,
  337.      city or area code, exchange code, and number. The various parts
  338.      of the phone number are frequently used to derive cost and
  339.      routing information, as well as what number is to be dialed. A
  340.      typical example of the data in a phone number field is
  341.      1-800-555-1212, corresponding to country 1 (USA), area 800
  342.      (inbound WATS), exchange 555, and number 1212.  
  343.  
  344.        Alternatively, this field may contain the notation
  345.      "-Unpublished-" in the case of a private node. In this case, the
  346.      keyword "Pvt" must appear on the line.  
  347.  
  348.      Field 7: Baud rate  
  349.  
  350.        This field contains one of the values:  300, 1200, 2400, 9600,
  351.      19200, or 38400, and defines the maximum baud rate supported by
  352.      the node.  
  353.  
  354.      Field 8: Flags   
  355.  
  356.        This optional field contains data about the specific operation
  357.      of the node, such as file requests, modem protocol supported,
  358.      etc.  Any text following the seventh comma on a data line is
  359.      taken collectively to be the flags field. The required format is
  360.      zero or more subfields, separated by commas. Each subfield
  361.      consists of a flag, possibly followed by a value.  
  362.  
  363.        The following flags define special operating conditions: 
  364.  
  365.           Flag     Meaning
  366.  
  367.           CM       Node accepts mail 24 hours a day
  368.           MO       Node does not accept human callers
  369.  
  370.  
  371.  
  372.      The Nodelist                                     Field 8: Flags
  373.  
  374.  
  375.      Page 7        TrapDoor's Faaaast NodeList Processor        Page 7
  376.  
  377.  
  378.        The following flags define modem protocols supported: 
  379.  
  380.           Flag     Meaning
  381.  
  382.           V21      CCITT V21   300 bps full duplex
  383.           V22      CCITT V22   1200 bps full duplex
  384.           V29      CCITT V29   9600 bps half duplex
  385.           V32      CCITT V32   9600 bps full duplex
  386.           V33      CCITT V33
  387.           V34      CCITT V34
  388.           H96      Hayes V9600
  389.           HST      USR Courier HST
  390.           MAX      Microcom AX/96xx series
  391.           PEP      Packet Ensemble Protocol
  392.  
  393.           NOTE:  Many V22 modems also support Bell 212A.  
  394.  
  395.           If no modem flag is given, Bell 212A is assumed for 1200
  396.           bps systems, CCITT V22bis is assumed for 2400 bps systems.  
  397.  
  398.        The following flags define type of error correction available.
  399.      A separate error correction flag should not be used when the
  400.      error correction type can be determined by the modem flag. For
  401.      instance, a modem flag of HST implies MNP.  
  402.  
  403.           Flag     Meaning
  404.  
  405.           MNP      Microcom Networking Protocol error correction
  406.           V42      LAP-M error correction w/fallback to MNP
  407.  
  408.        The following flags define the type(s) of compression of mail
  409.      packets supported.  
  410.  
  411.           Flag     Meaning
  412.  
  413.           MN       No compression supported
  414.  
  415.           NOTE:  The only compression method standard in FidoNet is
  416.           archiving, using the standard SEA ARC format, with archive
  417.           names defined by the specification for ARCMail 0.6. The
  418.           absence of the MN flag indicates that ARCMail 0.6
  419.           compression is supported by this node.  
  420.  
  421.        The following flags indicate the types of file/update requests
  422.      supported.  
  423.  
  424.           Flag     Meaning
  425.  
  426.           XA       Bark and WaZOO file/update requests
  427.           XB       Bark file/update requests, WaZOO file requests
  428.           XP       Bark file/update requests
  429.           XR       Bark and WaZOO file requests
  430.           XW       WaZOO file requests
  431.           XX       WaZOO file/update requests
  432.  
  433.  
  434.      The Nodelist                                     Field 8: Flags
  435.  
  436.  
  437.      Page 8        TrapDoor's Faaaast NodeList Processor        Page 8
  438.  
  439.  
  440.        The following flag defines gateways to other domains
  441.      (networks).  
  442.  
  443.           Flag     Meaning
  444.  
  445.           Gx..x    Gateway to domain 'x..x', where 'x..x` is a string
  446.                    of alphanumeric characters. Valid values for 'x..x'
  447.                    are assigned by the FidoNet International
  448.                    Coordinator. Current valid values of 'x..x' may be
  449.                    found in the notes at the end of the FidoNet
  450.                    nodelist.
  451.  
  452.        The following flags define the dedicated mail periods
  453.      supported. They have the form "#nn" or !nn where nn is the UTC
  454.      hour the mail period begins, # indicates Bell 212A
  455.      compatibility, and ! indicates incompatibility with Bell 212A.  
  456.  
  457.           Flag     Meaning
  458.  
  459.           #02      Zone 2 mail hour (02:30 - 03:30 UTC)
  460.           #09      Zone 1 mail hour (09:00 - 10:00 UTC)
  461.           #18      Zone 3 mail hour (18:00 - 19:00 UTC)
  462.  
  463.           NOTE: When applicable, the mail period flags may be strung
  464.           together with no intervening commas, eg. "#02#09". Only
  465.           mail hours other than that standard within a node's zone
  466.           should be given. Since observance of mail hour within one's
  467.           zone is mandatory, it should not be indicated.  
  468.  
  469.        The following flag defines user-specific values. If present,
  470.      this flag MUST be the last flag present in a nodelist entry.  
  471.  
  472.           Flag     Meaning
  473.  
  474.           Ux..x    A user-specified string, which may contain any
  475.                    alphanumeric character except blanks. This string
  476.                    may contain one to thirty-two characters of
  477.                    information that may be used to add user-defined
  478.                    data to a specific nodelist entry.
  479.  
  480.        The FidoNet International Coordinator (IC) is the ultimate
  481.      authority over what appears in the FidoNet nodelist. The IC may
  482.      temporarily make changes or additions to the flags as defined in
  483.      this document. The IC will then consult with The FidoNet
  484.      Technical Standardisation Commitee (FTSC) over the changes
  485.      needed to FTSC documents to reflect these temporary changes.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.      The Nodelist                                     Field 8: Flags
  497.  
  498.  
  499.      Page 9        TrapDoor's Faaaast NodeList Processor        Page 9
  500.  
  501.  
  502.   3.3. Example Nodelist Entries   
  503.  
  504.        The following are examples of nodelist data lines: 
  505.  
  506.           Host,102,SOCALNET,Los_Angeles_CA,Richard_Martz,
  507.                1-213-874-9484,2400,XP
  508.           ,101,Rainbow_Data,Culver_City_CA,Don_Brauns,
  509.                1-213-204-2996,2400,
  510.  
  511.   3.4. An Example Fake Pointnet  
  512.  
  513.        This is an example of a private pointnet: 
  514.  
  515.           ;A Private Secret Traplist for the other day -- fake crc 0 : 0
  516.           ;A
  517.           Zone,2,->
  518.           Region,31,->
  519.           ; the 2D part
  520.           Host,3160,The_Mad_Net,Vienna_Austria,Maximilian_Hantsch,
  521.                                           43-1-5567854,9600,MO,HST,XW
  522.           Pvt,1,TrapDoor_Development,Vienna_Austria,Maximilian_Hantsch,
  523.                                           -Unpublished-,9600,MO,HST,XW
  524.           Pvt,2,Yet_Unnamed,Moedling_Austria,Michael_Brunner,
  525.                                           -Unpublished-,9600,MO,HST,XW
  526.           Pvt,3,The_Mad_Point,Weissenbach_Austria,Thomas_Hantsch,
  527.                                           -Unpublished-,9600,MO,HST,XW
  528.           ; the 4D part
  529.           Host,310,->
  530.           ,6,The_Mad_Net,Vienna_Austria,Maximilian_Hantsch,
  531.                                           43-1-5567854,9600,MO,HST,XW
  532.           Point,1,TrapDoor_Development,Vienna_Austria,Maximilian_Hantsch,
  533.                                           -Unpublished-,9600,MO,HST,XW
  534.           Point,2,Yet_Unnamed,Moedling_Austria,Michael_Brunner,
  535.                                           -Unpublished-,9600,MO,HST,XW
  536.           Point,3,The_Mad_Point,Weissenbach_Austria,Thomas_Hantsch,
  537.                                           -Unpublished-,9600,MO,HST,XW
  538.           ;
  539.           ; An additional example:
  540.           ; I am going to override the nodelist entry for 2:310/11,
  541.           ; because it has changed recently.
  542.           ; For this feature to work, be sure to list this private
  543.           ; nodelist _before_ the main nodelist in your TrapList
  544.           ; configuration file.
  545.           ;
  546.           Host,310,->
  547.           ,11,Deep_Node,Vienna_Austria,Felix_Kasza,
  548.                                           43-1-123-4567,1200,CM,V21
  549.           ;
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.      The Nodelist                            An Example Fake Pointnet
  559.  
  560.  
  561.      Page 10       TrapDoor's Faaaast NodeList Processor       Page 10
  562.  
  563.  
  564.   4. The Nodediff    
  565.  
  566.   4.1. General Information    
  567.  
  568.        With more than ten thousand nodes as of this date ('91), the
  569.      nodelist, even in archive form, is a substantial document (or
  570.      file). Since distribution is via electronic file transfer, this
  571.      file is NOT routinely distributed.  Instead, when a new nodelist
  572.      is prepared, it is compared with the previous week's nodelist,
  573.      and a file containing only the differences is created and
  574.      distributed.  
  575.  
  576.        The distribution file, called NODEDIFF.nnn, where nnn is the
  577.      day-of-year of publication, is actually an editing script which
  578.      will transform the previous week's nodelist into the current
  579.      nodelist.  
  580.  
  581.        For actual distribution, NODEDIFF.nnn is packed into an
  582.      archive file named NODEDIFF.Ann, where nn are the last two
  583.      digits of day-of-year.  
  584.  
  585.        You can skip the next chapter if you want. It is just here to
  586.      supply you with additional background information about the
  587.      format of the nodediff.  
  588.  
  589.   4.2. Details     
  590.  
  591.        The first line of NODEDIFF.nnn is an exact copy of the first
  592.      line of LAST WEEK'S nodelist. This is used as a first-level
  593.      confidence check to ensure that the right file is being edited.
  594.      The second and subsequent lines are editing commands and editing
  595.      data.  
  596.  
  597.        There are three editing commands and all have the same format: 
  598.  
  599.           <command><number> 
  600.  
  601.        <command> is a 1-letter command; A, C, or D. <number> is a
  602.      decimal number greater than zero, and defines the number of
  603.      lines to be operated on by the command. Each command appears on
  604.      a line by itself. The commands have the following meanings: 
  605.  
  606.        Ann - Add the following nn lines to the output file.
  607.        Cnn - Copy nn unchanged lines from the input to the output file.
  608.        Dnn - Delete (or skip) nn lines from the input file.
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.      The Nodediff                                          Details
  621.  
  622.  
  623.      Page 11       TrapDoor's Faaaast NodeList Processor       Page 11
  624.  
  625.  
  626.        The following illustrates how the first few lines of
  627.      NODEDIFF.213 might look: 
  628.  
  629.           ;A Friday, July 25, 1986 -- Day number 206 : 27712
  630.           D2
  631.           A2
  632.           ;A Friday, August 1, 1986 -- Day number 213 : 05060
  633.           ;A
  634.           C5
  635.  
  636.        This fragment illustrates all three editing commands. The
  637.      first line is the first line from NODELIST.206. The next line
  638.      says "delete the first two lines" from NODELIST.206. These are
  639.      the identification line and the line following it. The next
  640.      command says "add the next two lines" to NODELIST.213. The two
  641.      data lines are followed by a command which says "copy five
  642.      unchanged lines" from NODELIST.206 to NODELIST.213. Notice that
  643.      the first line added will ALWAYS contain the new nodelist's
  644.      CRC.  
  645.  
  646.        Since only the differences will be distributed, it is
  647.      important to ensure the accuracy of the newly created nodelist.
  648.      This is the function of the CRC mentioned above. If the CRC in
  649.      the Nodediff and the calculated CRC do not equal, one of the
  650.      input files has been corrupted. If they are the same, the
  651.      probability is very high (but not 100%) that the output file is
  652.      accurate.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.      The Nodediff                                          Details
  683.  
  684.  
  685.      Page 12       TrapDoor's Faaaast NodeList Processor       Page 12
  686.  
  687.  
  688.   5. Configuration     
  689.  
  690.        Configuration statements are given to TrapList by means of a
  691.      configuration file. This file can either be called
  692.      "TrapList.cfg", or, more generally, "fido.cfg". The
  693.      configuration file will be first searched for in the current
  694.      directory, then in "MAIL:". You can override this search
  695.      sequence and specify your own alternate configuration file using
  696.      the CONFIG commandline keyword, such as in 
  697.  
  698.           TrapList CONFIG DEVS:traplist-configuration 
  699.  
  700.        You can also specify the path and filename of the
  701.      configuration file by means of an environment variable FCFGPATH.
  702.      For example, 
  703.  
  704.           setenv FCFGPATH DH0:Configs/Fido-Config.txt 
  705.  
  706.        For detailed information on the global configuration file
  707.      "fido.cfg", please consult additional documentation about the
  708.      general structure of this file, how several applications can
  709.      share configuration keywords, etc.  
  710.  
  711.        Please note that the configuration statements are neither case
  712.      sensitive nor do they have to appear in any specific order. Only
  713.      one statement should appear on a single line.  
  714.  
  715.  
  716.  
  717.  
  718.   6. Configuration Statements    
  719.  
  720.   6.1. BUFFERSIZE buffersize    
  721.  
  722.        TrapList will buffer all file i/o to speed up the nodelist
  723.      processing. This statement allows you to specify the amount of
  724.      memory TrapList will use for each of its buffers. This value
  725.      should be given in bytes. TrapList will always use at least
  726.      buffers of 4096 bytes, even if a lower value is specified with
  727.      BUFFERSIZE. The default is 32768 bytes.  
  728.  
  729.      Example:  BufferSize 65536 
  730.  
  731.   6.2. (NO)CHECKCRC     
  732.  
  733.        When this configuration statement is used, TrapList will check
  734.      the CRC of the freshly generated nodelist when applying a diff.
  735.      If the CRC is not what it is supposed to be, TrapList will issue
  736.      a warning, delete the new nodelist and continue to use the old
  737.      one instead. That way, you can always be sure to have a valid
  738.      nodelist.  
  739.  
  740.      Example:  CheckCRC 
  741.  
  742.  
  743.  
  744.      Configuration Statements                         (NO)CHECKCRC
  745.  
  746.  
  747.      Page 13       TrapDoor's Faaaast NodeList Processor       Page 13
  748.  
  749.  
  750.   6.3. COMMENT comment-identifier    
  751.  
  752.        When the nodelist is parsed, and TrapList encounters a comment
  753.      line, it will compare the comment-identifier (";S" for Sysop
  754.      comments, ";U" for User comments, a.s.o.) with the identifiers
  755.      you specified here. If it finds the identifier listed, and the
  756.      REPORT keyword is in effect, the comment line will be written to
  757.      the reportfile (see REPORT).  
  758.  
  759.      Examples: Comment SU       ; list "Sysop" and "User" comments 
  760.                Comment A        ; list "All" comments 
  761.                Comment SUFA     ; list all comments 
  762.  
  763.   6.4. COST costs dial-prefix [dial-prefix...]  
  764.  
  765.        Specify phone costs per minute for a group of telephone
  766.      numbers. When TrapDoor reads a phonenumber from the nodelist,
  767.      and you have defined a certain cost, TrapDoor will be able to
  768.      show you the total cost of your call. If you specify minus one
  769.      ("-1") as the costs for a number, TrapDoor will never call
  770.      there. You can use this to prevent TrapDoor from calling
  771.      "-Unpublished-" numbers. See the example configuration file for
  772.      more details. You can specify multiple dial prefixes for a
  773.      single cost entry.  
  774.  
  775.      Examples: Cost 67   "43-1-"     ; 0.67 ATS/min for local calls 
  776.                Cost 1333 "30-" "44-" ; Greece and UK cost the same 
  777.                Cost -1   "-"         ; -Unpublished- = undialable 
  778.                Cost 2800 ""          ; 28 ATS/min for all others 
  779.  
  780.   6.5. (NO)DELOLDDIFFS     
  781.  
  782.        This tells TrapList to delete old nodediffs when they have
  783.      been applied successfully.  
  784.  
  785.      Example:  DelOldDiffs 
  786.  
  787.   6.6. (NO)DELOLDLISTS     
  788.  
  789.        This tells TrapList to delete old nodelists when they have
  790.      been "diff'd" into a new one.  
  791.  
  792.      Example:  DelOldLists 
  793.  
  794.   6.7. DIAL original-string replacement-string   
  795.  
  796.        Specify a dial translation for phone numbers. When a
  797.      phonenumber is read in from the nodelist by TrapDoor, these dial
  798.      translations will be applied. If the beginning of the telephone
  799.      number matches the original-string, it will be replaced by the
  800.      replacement-string. Dial translations will be searched from
  801.      first to last, and only the first match will be applied. After
  802.      the first match, no further translation will be done.  
  803.  
  804.  
  805.  
  806.      Configuration StatementsDIAL original-string replacement-string
  807.  
  808.  
  809.      Page 14       TrapDoor's Faaaast NodeList Processor       Page 14
  810.  
  811.  
  812.      Examples: Dial "43-1-"  ""   ; strip country and exchange code 
  813.                                   ; for local calls 
  814.                Dial "43-"   "0"   ; replace country code with "0" 
  815.                                   ; for the rest of Austria 
  816.                Dial "-"     "-"   ; do not translate "-Unpublished-" 
  817.                Dial ""     "00"   ; add "00" to other numbers 
  818.  
  819.   6.8. (NO)GENNEWSTYLE     
  820.   6.9. (NO)GENOLDSTYLE     
  821.  
  822.        These two keywords are now obsolete and are no longer
  823.      supported. Remove them from your config files.  
  824.  
  825.   6.10. NODELIST nodelistname [DIFF diffname]  
  826.  
  827.        This specifies the name of a nodelist file to look for.
  828.      TrapList will append day numbers to the filename and search for
  829.      the nodelist with the highest number. If the DIFF keyword was
  830.      specified also, TrapList will try to locate a matching nodediff
  831.      file and apply it to the nodelist.  
  832.  
  833.        If a node is listed in more than one nodelist (for example, in
  834.      the main FidoNet nodelist and in a private pointnet), the data
  835.      from the first nodelist will be taken (in the order that the
  836.      nodelists are listed in your configuration file). This allows
  837.      you to override data for a node in the nodelist; just list the
  838.      system in your private nodelist and specify the name of the
  839.      private list before the main nodelist in the configuration file
  840.      for TrapList.  
  841.  
  842.        Note: Nodelists will be scanned in reverse order than
  843.      specified. This is not a fault.  
  844.  
  845.      Examples: Nodelist "NODELIST" DIFF "NODEDIFF" 
  846.                Nodelist "POINTNET" 
  847.  
  848.   6.11. NODELISTPATH path    
  849.  
  850.        This (required) configuration statement tells TrapList where
  851.      to find Nodelist and Nodediff files and where to put its index
  852.      files. It is not necessary to terminate the path specification
  853.      with a slash.  
  854.  
  855.      Example:  NodeListPath "Nodelist:" 
  856.  
  857.   6.12. PASSWORD password node [node...]  
  858.  
  859.        Associate a password with a certain nodenumber. TrapList will
  860.      put the password into the extra file and TrapDoor will then
  861.      automatically use that password when it establishes
  862.      communication with that node. Also, on incoming calls, TrapDoor
  863.      will check the password for the calling node and hang up if
  864.      incorrect.  
  865.  
  866.  
  867.  
  868.      Configuration Statements        PASSWORD password node [node...]
  869.  
  870.  
  871.      Page 15       TrapDoor's Faaaast NodeList Processor       Page 15
  872.  
  873.  
  874.        If you set up a password with a node that is also listed as a
  875.      Zone Coordinator, Regional Coordinator, Net Coordinator, or Hub
  876.      Coordinator, make sure you specify all of the node's addresses,
  877.      or you might experience strange problems when calling one of the
  878.      Coordinator's addresses. Note that you may specify multiple node
  879.      addresses for a single password, especially for that purpose.  
  880.  
  881.        There also is a special password for nodes you want to disable
  882.      from connecting to your system, "--NONE--". You may want to use
  883.      this keyword for your own addresses, thus forbidding any caller
  884.      from (fraudulently) using your address. TrapDoor will
  885.      immediately disconnect if anyone calls you with the given
  886.      address.  
  887.  
  888.      Examples: Password "secret" 2:310/6 2:3160/0 
  889.                Password "geheim" 2:310/3 
  890.  
  891.   6.13. (NO)QUIET     
  892.  
  893.        Suppress warnings about nodes defined more than once. You can
  894.      use this to prevent TrapList from displaying "Duplicate Entry
  895.      for Node..." when you process several nodelists which contain a
  896.      few redundant node definitions (e.g. a pointnet or a region
  897.      nodelist together with the main fidonet nodelist).  
  898.  
  899.        Note: The "Duplicate Entry" message will still be written to
  900.      the reportfile.  
  901.  
  902.      Examples: Quiet 
  903.                NoQuiet 
  904.  
  905.   6.14. REPORT reportfile    
  906.  
  907.        Write some statistics about the processed nodelists into the
  908.      given reportfile in addition to displaying them on stdout (the
  909.      shell window). In conjunction with other utilities, such as
  910.      Electric Herald, this can be used to automatically send the
  911.      sysop information about freshly compiled nodelists and similar
  912.      things. If you use the COMMENT keyword, selected comment lines
  913.      from the nodelist will also be sent to the reportfile.  
  914.  
  915.      Example:  Report "Mail:Report.txt" 
  916.  
  917.   6.15. ZONE zone    
  918.  
  919.        This is the default zone that TrapList should use for
  920.      nodelists that do not contain a Zone keyword, i.e. Pointnets and
  921.      similar private lists.  
  922.  
  923.      Example:  Zone 2 
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.      Configuration Statements                             ZONE zone
  931.  
  932.  
  933.      Page 16       TrapDoor's Faaaast NodeList Processor       Page 16
  934.  
  935.  
  936.   7. Example Configuration File   
  937.  
  938.           ; **********************************************
  939.           ; ***   Sample TrapList configuration file   ***
  940.           ; **********************************************
  941.  
  942.           Zone 2                       ; default zone number
  943.           NodeListPath "Mail:Nodelist" ; my nodelist directory
  944.  
  945.           BufferSize 65536          ; use 64k buffer for file i/o
  946.  
  947.           NodeList "NODELIST" Diff "NODEDIFF"  ; nodelist & -diff
  948.           NodeList "POINTNET"                  ; private pointnet
  949.  
  950.           CheckCRC       ; make sure that nodelists are okay
  951.           DelOldLists    ; delete the old nodelists when diff'ed
  952.           DelOldDiffs    ; delete the old nodediffs when processed
  953.  
  954.           Report t:TL.report    ; put reports into this file
  955.           Comment SA            ; write Sysop and All comments
  956.                                 ; to the report file
  957.           ; Passwords.
  958.           ; note that you can specify several nodenumbers that
  959.           ; all use the same password. this is for AKA addresses.
  960.  
  961.           Password 123456   2:310/3.0
  962.           Password --NONE-- 2:310/6.0   2:3160/0.0
  963.           Password pwd      2:310/11.32 2:3210/32.0
  964.           Password guess    2:310/11 2:2/3 2:2/4 2:2/5 27:27/1
  965.  
  966.           ; phone number translations.
  967.  
  968.           Dial "43-1-" ""       ; local calls
  969.           Dial "43-"   "0"      ; within Austria
  970.           Dial "49-"   "060-"   ; use shortcut to Germany
  971.           Dial "-"     "-"      ; leave "-Unpublished-" as is
  972.           Dial ""      "00"     ; add "00" to other entries
  973.  
  974.           ; cost tables (in Austrian Groschen)
  975.           Cost 67    "43-1-"    ; local calls in Vienna
  976.           Cost 400   "43-2280-" ; somewhere in Austria
  977.           Cost 1330  "213-"     ; Algeria
  978.           Cost 867   "49-"      ; FRG (Germany)
  979.           Cost 2800  "1-907-"   ; Alaska
  980.           Cost 1800  "1-"       ; USA, Kanada
  981.           Cost -1    "-"        ; forbid calls to -Unpublished-
  982.           Cost 2800  ""         ; Rest of the World
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.      Example Configuration File
  993.  
  994.  
  995.      Page 17       TrapDoor's Faaaast NodeList Processor       Page 17
  996.  
  997.  
  998.   8. Processing The Lists   
  999.  
  1000.        To process the latest nodelist and nodediff, simply call
  1001.      TrapList with "TrapList". Easy, isn't it? You should get an
  1002.      output quite like this: 
  1003.  
  1004.           TrapList 1.35 -- The TrapDoor Nodelist Processor
  1005.              © Copyright 1990, 1991 by Martin J. Laubach
  1006.                                    and Maximilian Hantsch
  1007.                      All rights reserved
  1008.  
  1009.           Applying NODEDIFF.054 to NODELIST.047
  1010.           Parsing NODELIST.054
  1011.            Zone 2  Europe
  1012.            Zone 1  North_America
  1013.            Zone 3  Oceania
  1014.            Zone 4  America_Latina
  1015.            Zone 5  AFRICA
  1016.           Sorting
  1017.           Processing
  1018.           Writing
  1019.  
  1020.           Total Nodes Processed        =   7360
  1021.           Bad Nodes                    =      0
  1022.           Unique Nodes                 =   7360
  1023.           Nodes Deleted (Down)         =    119
  1024.           Points                       =      0
  1025.           -------------------------------------
  1026.           Zone Coordinators Listed     =      5
  1027.           Regional Coordinators Listed =     38
  1028.           Network Coordinators Listed  =    300
  1029.           Hub Coordinators Listed      =    405
  1030.           =====================================
  1031.           Diff'ing                     =   0:27
  1032.           Parsing                      =   0:19
  1033.           Sorting                      =   0:06
  1034.           Processing                   =   0:02
  1035.           Writing                      =   0:05
  1036.           -------------------------------------
  1037.           Total time needed            =   0:59
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.      Processing The Lists
  1055.  
  1056.  
  1057.      Page 18       TrapDoor's Faaaast NodeList Processor       Page 18
  1058.  
  1059.  
  1060.   9. Return Values    
  1061.  
  1062.        If everything went all right, and the index and extra files
  1063.      were both correctly produced and renamed, TrapList will return
  1064.      zero (0).  
  1065.  
  1066.        The nodelist index and extra files will be automatically
  1067.      updated through traplist.library. Programs which access the
  1068.      nodelist via traplist.library will automatically use the fresh
  1069.      index; there is no need to quit and restart such programs. If
  1070.      updating the index file fails (due to some disk i/o error, for
  1071.      example) TrapList will return 10.  
  1072.  
  1073.        On any other error, TrapList will return 20.  
  1074.  
  1075.        Note that in case of an error, the old index and extra files
  1076.      will be left unchanged, so TrapDoor will still be able to access
  1077.      a valid nodelist, even though it will not be the latest one in
  1078.      such a case.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.      Return Values
  1117.  
  1118.  
  1119.      Page 19       TrapDoor's Faaaast NodeList Processor       Page 19
  1120.  
  1121.  
  1122.   10. Past And Future   
  1123.  
  1124.        TrapList was originally intended as a stopgap measure while
  1125.      waiting for Jürgen Hermann's final release version of CList.
  1126.      Since a lack of a working CList also prevented us from shipping
  1127.      a node-able TrapDoor, we had to do something about it -- that
  1128.      was how TrapList started.  
  1129.  
  1130.        Since the first release (which came together with TrapDoor
  1131.      1.50) quite a few things have changed. Not only have cost
  1132.      entries, nodelist CRC checking and passwords longer than 6
  1133.      characters been implemented, but also the whole nodelist concept
  1134.      has been completely reworked: TrapList now uses a new index and
  1135.      extra file format and comes with a shared Amiga library to
  1136.      access these files. Other products (such as BBSs or mail
  1137.      tossers) can make use of traplist.library to obtain data from
  1138.      the TrapList-indexed nodelist.  
  1139.  
  1140.        On the other hand, the project of also generating a version 6
  1141.      nodelist format has been dropped. TrapList and the related
  1142.      shared library offer so many advantages over the aged version 6
  1143.      format; we hope that most new programs will support
  1144.      "traplist.library".  
  1145.  
  1146.        "traplist.library" offers another entirely new feature: the
  1147.      extra file stores arbitrary data and associates it with a node
  1148.      address. Third party programs as well as TrapDoor can use this
  1149.      "extra database" to store their node-specific data. For example,
  1150.      TrapDoor now uses the extra file to hold accounting information
  1151.      (how many times that node was called, how many times it was
  1152.      busy, etc.) as well as the session password and "special config"
  1153.      commandlines. Other uses (to be implemented in other programs)
  1154.      could be: Packer/Unpacker to be used for echomail to that node,
  1155.      Areafix password, and many more.  
  1156.  
  1157.        "traplist.library" now also allows programs to scan the
  1158.      nodelist (to produce a list of nodes in your own net, for
  1159.      example). In addition to that, it also has an ARexx interface to
  1160.      allow easy usage from ARexx programs.  
  1161.  
  1162.        If you wish to know more about the programming interface of
  1163.      "traplist.library", please refer to the documentation
  1164.      "tl_lib.Man".  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.      Past And Future
  1179.  
  1180.  
  1181.      Page 20       TrapDoor's Faaaast NodeList Processor       Page 20
  1182.  
  1183.  
  1184.   11. Registration     
  1185.  
  1186.        TrapList is a copyrighted product that has been made available
  1187.      to you as part of the TrapDoor project and thus, as Shareware.
  1188.      All terms of the license agreement for TrapDoor also are true
  1189.      for TrapList except as otherwise stated herein. Please consult
  1190.      the documentation for TrapDoor for the complete license.  
  1191.  
  1192.        If you register TrapDoor, you automatically also gain a
  1193.      license to use TrapList.  
  1194.  
  1195.        Should you decide that you wish to use TrapList on its own,
  1196.      without registering TrapDoor, a ShareWare registration fee of
  1197.      ATS 200,- is suggested. By cooperating with this concept you
  1198.      help to ensure continued development of this product.  
  1199.  
  1200.        Site license information for commercial and government use can
  1201.      be obtained directly from the authors.  
  1202.  
  1203.        No person(s) or businesses other than the authors are
  1204.      authorized to accept any registration or distribution fees in
  1205.      any form whatsoever. The only people who will be acknowledged as
  1206.      registered users are those who have either registered TrapDoor
  1207.      or sent ATS 200,- to: 
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.                            TrapDoor Development
  1214.                           c/o Maximilian Hantsch
  1215.                       Matzleinsdorfer Platz 3-4/3/10
  1216.                                 A-1050 Wien
  1217.                              Austria / Europe
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.      Registration
  1241.  
  1242.  
  1243.      Page 21       TrapDoor's Faaaast NodeList Processor       Page 21
  1244.  
  1245.  
  1246.   12. Politics     
  1247.  
  1248.   12.1. Distribution     
  1249.  
  1250.        TrapList may be redistributed with two restrictions. First, it
  1251.      must be distributed as part of the TrapDoor package. Second, the
  1252.      distributor may only charge a fee up to the costs of obtaining a
  1253.      public domain diskette from Fred Fish for the complete package.  
  1254.  
  1255.        The distributor agrees to cease distributing the programs and
  1256.      data involved if requested to do so by the author. The
  1257.      distributor may only distribute an unmodified copy of the
  1258.      original TrapDoor package, with all the supplied documentation
  1259.      and copyright notices intact and without any files being added,
  1260.      changed or omitted.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.   12.2. Support     
  1272.  
  1273.        If you have any suggestions, bug reports etc., feel free to
  1274.      contact the authors of TrapList/TrapDoor at the above address.
  1275.      Additionally, you can reach us at: 
  1276.  
  1277.           Maximilian Hantsch              Martin Laubach
  1278.           Fido:   2:310/6                 Fido:   2:310/3.14
  1279.           Uucp:   max@madvie.at           Uucp:   mjl@alison.at
  1280.  
  1281.        Also, there is a FidoNet Echomail conference called TRAPDOOR,
  1282.      which should be available at major backbones. This conference is
  1283.      in English and intended for the users of TrapDoor and, of
  1284.      course, TrapList as well. There, you can freely exchange your
  1285.      experience with these programs, discuss future enhancements you
  1286.      would like to see etc. Both authors will participate in the
  1287.      conference and try to assist you.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.      Politics                                              Support
  1303.  
  1304.  
  1305.      Page 22       TrapDoor's Faaaast NodeList Processor       Page 22
  1306.  
  1307.  
  1308.   12.3. No Warranty    
  1309.  
  1310.        THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED
  1311.      BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
  1312.      COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS
  1313.      IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  1314.      INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  1315.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
  1316.      RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
  1317.      YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  1318.      ALL NECESSARY SERVICING, REPAIR OR CORRECTION.  
  1319.  
  1320.        IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  1321.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  1322.      REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
  1323.      FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  1324.      CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  1325.      THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  1326.      BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  1327.      PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  1328.      PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED
  1329.      OF THE POSSIBILITY OF SUCH DAMAGES.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.   12.4. Disclaimer     
  1335.  
  1336.        No warranty, either express or implied, is made with respect
  1337.      to the fitness or merchantability of TrapList.  
  1338.  
  1339.        Maximilian Hantsch and Martin Laubach (referred to as "the
  1340.      authors"), reserve the right to not develop any future versions
  1341.      of TrapList.  
  1342.  
  1343.        The authors will try to make a good faith attempt at
  1344.      correcting any problems if any are discovered, but are in no way
  1345.      required, nor bound to correct them.  
  1346.  
  1347.        The authors neither assume or accept any responsibility for
  1348.      the use or misuse of this program. They also will not be held
  1349.      liable for damages or any compensation beyond the original
  1350.      registration fee due to loss of profit or any other damages
  1351.      arising out of the use, or inability to use this program.  
  1352.  
  1353.        Neither Maximilian Hantsch nor Martin Laubach will be liable
  1354.      for any damage arising from the failure of this program to
  1355.      perform as described, or any destruction of other programs or
  1356.      data residing on a system attempting to run the program. While
  1357.      we know of no damaging errors, the user of this program uses it
  1358.      at his or her own risk.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.      Politics                                           Disclaimer
  1365.  
  1366.  
  1367.      Page 23       TrapDoor's Faaaast NodeList Processor       Page 23
  1368.  
  1369.  
  1370.   13. Acknowledgements     
  1371.  
  1372.        The following names are either trademarks or the efforts of
  1373.      the person and/or company listed: 
  1374.  
  1375.           Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  1376.           ARC by System Enhancement Associates.
  1377.           Chameleon Editor and CList by Jürgen Hermann.
  1378.           Fido and FidoNet are trademarks of Tom Jennings,
  1379.                          Fido Software.
  1380.           License Agreement inspired by Jack Radigan
  1381.                          and the GNU General Public License.
  1382.           Many Thanks to our Alpha and Beta testing crew, including,
  1383.                          but not limited to:
  1384.                          Arnout Grootveld, Carl-Christian Kanne,
  1385.                          Heiko Richter, Johannes Mistelbauer,
  1386.                          Manfred Schädler, Peter Wlcek, René Hexel,
  1387.                          Telepro Technologies, Tony Miller ...
  1388.           Nodelist and Nodediff Information from FTS-0005.
  1389.           Special Thanks to all our Registered TrapDoor Users.
  1390.           TrapDoor by Maximilian Hantsch and Martin Laubach.
  1391.           TrapList by Martin Laubach and Maximilian Hantsch.
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.      Acknowledgements
  1427.  
  1428.  
  1429.      Page I        TrapDoor's Faaaast NodeList Processor        Page I
  1430.  
  1431.  
  1432.   Road Map
  1433.  
  1434.  
  1435.         1. Introduction    .....................................    2
  1436.         2. Basics    ...........................................    2
  1437.         3. The Nodelist   ......................................    3
  1438.            3.1. General Information   ..........................    3
  1439.            3.2. Details    .....................................    3
  1440.            Field 1: Keyword  ...................................    4
  1441.            Field 2: Zone/Region/Net/Node number ................    5
  1442.            Field 3: Node name ..................................    5
  1443.            Field 4: Location  ..................................    6
  1444.            Field 5: Sysop name .................................    6
  1445.            Field 6: Phone number ...............................    6
  1446.            Field 7: Baud rate ..................................    6
  1447.            Field 8: Flags  .....................................    6
  1448.            3.3. Example Nodelist Entries  ......................    9
  1449.            3.4. An Example Fake Pointnet .......................    9
  1450.         4. The Nodediff   ......................................   10
  1451.            4.1. General Information   ..........................   10
  1452.            4.2. Details    .....................................   10
  1453.         5. Configuration    ....................................   12
  1454.         6. Configuration Statements   ..........................   12
  1455.            6.1. BUFFERSIZE buffersize   ........................   12
  1456.            6.2. (NO)CHECKCRC    ................................   12
  1457.            6.3. COMMENT comment-identifier   ...................   12
  1458.            6.4. COST costs dial-prefix [dial-prefix...] ........   13
  1459.            6.5. (NO)DELOLDDIFFS    .............................   13
  1460.            6.6. (NO)DELOLDLISTS    .............................   13
  1461.            6.7. DIAL original-string replacement-string  .......   13
  1462.            6.8. (NO)GENNEWSTYLE    .............................   14
  1463.            6.9. (NO)GENOLDSTYLE    .............................   14
  1464.            6.10. NODELIST nodelistname [DIFF diffname] .........   14
  1465.            6.11. NODELISTPATH path   ...........................   14
  1466.            6.12. PASSWORD password node [node...] ..............   14
  1467.            6.13. (NO)QUIET    ..................................   15
  1468.            6.14. REPORT reportfile   ...........................   15
  1469.            6.15. ZONE zone   ...................................   15
  1470.         7. Example Configuration File  .........................   16
  1471.         8. Processing The Lists  ...............................   17
  1472.         9. Return Values   .....................................   18
  1473.         10. Past And Future  ...................................   19
  1474.         11. Registration    ....................................   20
  1475.         12. Politics    ........................................   21
  1476.            12.1. Distribution    ...............................   21
  1477.            12.2. Support    ....................................   21
  1478.            12.3. No Warranty   .................................   22
  1479.            12.4. Disclaimer    .................................   22
  1480.         13. Acknowledgements    ................................   23
  1481.  
  1482.  
  1483.                     "This is the end. Please log off."
  1484.  
  1485.  
  1486.  
  1487.  
  1488.      Road Map
  1489.  
  1490.